Instructions for Twistory 2.1


Person Records: #p

     A person record begins with the characters "#p". Here is an example of the information for four people:

#p <nat>British<o>king<n>George V<fa>Edward VII<b>1865 Jun 3<ac>1910 May 6<d>1936 Jan 20
#p <nat>British<o>king<n>Edward VIII<fa>George V<b>1894 Jun 23<ac>1936 Jan 20<ab>1936 Dec 11<d>1972
#p <nat>British<o>king<n>George VI<fa>George V<b>1895 Dec 14<ac>1936 Dec 11<d>1952 Feb 6
#p <nat>British<o>queen<n>Elizabeth II<fa>George VI<b>1926 Apr 21<ac>1952 Feb 6
#p <nat>British<o>prince<n>Charles<mo>Elizabeth II<b>1948 Nov 14

     Family relations are described by the <fa> and <mo> fields. The creation of the family tree in the genealogy views is dependent on those links being specified in the database. A person's record may specify his/her father and/or mother by name, but the parents must then also be in the database.

     Children are specified only by their own links to their parents. This seems to be the simplest way to implement family relations in the database, since one may have many children, and several spouses, but one usually has unique parents. (In the case of adoption, where there could be more than two parents, usually only one of the parents is a historical figure who would appear in the database. Failing that, Twistory cannot yet treat this case.) Unions (marriages, etc.) do not appear in genealogy windows, but that may be an option in future. Relations other than parent-child cannot be specified directly; the intermediate person(s) must also be in the database. (For example, the relationship of uncle requires both the appropriate parent and grandparent to be in the database, in order for that relation to be revealed in some genealogy window.)

     The occupation field <o> is provided so that certain categories of people may be selected for viewing. They should be first defined in a menu item (#i) record. Multiple occupations may be given for one person. Certain occupations, especially leaders, have distinct icons in the map view.

The last item in the default menu, "family," is not strictly an occupation. It allows a user who has put his/her own family tree into the database to select them as a distinct group by putting "<o>family" with each person. The person categories may actually be anything, not just an occupation. But they are still defined with the <o> field.

     The nationality field <nat> is provided so that a person's time-line bar appears in an appropriate colour. The colour used will be the one assigned to the geographical region identified in this field. Look at this example:

#c <n>France<l>47N03E<rad>400<nat>French<reg>Europe<col>100 100 80
...
#p <nat>French<o>author<n>Molière<aka>Jean Baptiste Poquelin<b>1622<d>1673

Molière's time-line bar appears in light yellow (red=100%; green=100%; blue=80%), along with all of his countrymen.